home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 7 / Amiga Format AFCD07 (Dec 1996, Issue 91).iso / serious / shareware / comms / non-internet / samba / docs / smbclient.0 < prev    next >
Text File  |  1996-07-01  |  31KB  |  859 lines
  1.  
  2.  
  3.  
  4. SMBCLIENT(1)                smbclient                SMBCLIENT(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        smbclient - ftp-like Lan Manager client program
  9.  
  10. SSYYNNOOPPSSIISS
  11.        ssmmbbcclliieenntt sseerrvviicceennaammee [ ppaasssswwoorrdd ] [ --AA ] [ --EE ] [ --LL _h_o_s_t
  12.        ] [ --MM _h_o_s_t ] [ --II _I_P _n_u_m_b_e_r ] [ --NN ] [ --PP ] [ --UU _u_s_e_r_n_a_m_e
  13.        ]  [ --dd _d_e_b_u_g_l_e_v_e_l ] [ --ll _l_o_g _b_a_s_e_n_a_m_e ] [ --nn _n_e_t_b_i_o_s _n_a_m_e
  14.        ] [ --OO _s_o_c_k_e_t _o_p_t_i_o_n_s ] [ --pp _p_o_r_t _n_u_m_b_e_r ]
  15.  
  16. DDEESSCCRRIIPPTTIIOONN
  17.        This program is part of the Samba suite.
  18.  
  19.        ssmmbbcclliieenntt is a client that can 'talk'  to  a  Lan  Manager
  20.        server.  It offers an interface similar to that of the ffttpp
  21.        program (see ffttpp((11)))).. OOppeerraattiioonnss iinncclluuddee tthhiinnggss lliikkee  ggeett--
  22.        ttiinngg  ffiilleess  ffrroomm tthhee server to the local machine, putting
  23.        files from the local machine  to  the  server,  retrieving
  24.        directory information from the server and so on.
  25.  
  26.        NOTE:  Ricky Poulten (poultenr@logica.co.uk) has written a
  27.        "tar" extension to smbclient that allows you  to  back  up
  28.        and restore your lan-manager compatible network using smb-
  29.        client.
  30.  
  31.        You can fetch the tar  extension  from  the  "contributed"
  32.        section                     on                     nimbus.
  33.        ftp://nimbus.anu.edu.au/pub/tridge/samba/contributed/
  34.  
  35.  
  36.  
  37. OOPPTTIIOONNSS
  38.        sseerrvviicceennaammee
  39.           sseerrvviicceennaammee is the name of the service you want to  use
  40.           on   the   server.   A  service  name  takes  the  form
  41.           \\\\sseerrvveerr\\sseerrvviiccee where sseerrvveerr is the  netbios  name  of
  42.           the Lan Manager server offering the desired service and
  43.           sseerrvviiccee is the name of the  service  offered.  Thus  to
  44.           connect  to  the  service  "printer" on the Lan Manager
  45.           server "lanman", you would use the servicename
  46.  
  47.                     \\\\llaannmmaann\\pprriinntteerr
  48.  
  49.           Note that the server name required is  NOT  necessarily
  50.           the host name of the server! The name required is a Lan
  51.           Manager server name, which may or may not be  the  same
  52.           as the hostname of the machine running the server.
  53.  
  54.        ppaasssswwoorrdd
  55.           ppaasssswwoorrdd  is the password required to access the speci-
  56.           fied service on the specified server. If supplied,  the
  57.           --NN option (suppress password prompt) is assumed.
  58.  
  59.           There  is  no  default password. If no password is sup-
  60.           plied on the command line (either here or using the  --UU
  61.  
  62.  
  63.  
  64. smbclient                   17/1/1995                           1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SMBCLIENT(1)                smbclient                SMBCLIENT(1)
  71.  
  72.  
  73.           option (see below)) and --NN is not specified, the client
  74.           will prompt for a password, even if the desired service
  75.           does  not  require one. (If prompted for a password and
  76.           none is required, simply press ENTER to provide a  null
  77.           password.)
  78.  
  79.           Note:  Some  servers  (including  OS/2  and Windows for
  80.           Workgroups) insist on an uppercase password.  Lowercase
  81.           or  mixed  case  passwords  may  be  rejected  by these
  82.           servers.
  83.  
  84.           Be cautious about including passwords in scripts.
  85.  
  86.        --AA
  87.  
  88.           This parameter, if specified, causes the maximum  debug
  89.           level  to  be  selected.  Be warned that this generates
  90.           prodigious amounts of debug data. There is also a secu-
  91.           rity  issue  involved,  as  at  the maximum debug level
  92.           cleartext passwords may be written to some log files.
  93.  
  94.        --LL
  95.  
  96.           This option allows you to look  at  what  services  are
  97.           available  on  a  server.  You  use it as "smbclient -L
  98.           host" and a list should appear.  The -I option  may  be
  99.           useful  if  your  netbios names don't match your tcp/ip
  100.           host names or if you are trying  to  reach  a  host  on
  101.           another network. For example:
  102.  
  103.           smbclient -L ftp -I ftp.microsoft.com
  104.  
  105.           will  list  the  shares  available on microsofts public
  106.           server.
  107.  
  108.        --MM
  109.  
  110.           This options allows you to  send  messages,  using  the
  111.           "WinPopup"  protocol,  to another computer. Once a con-
  112.           nection is established  you  then  type  your  message,
  113.           pressing ^D (control-D) to end.
  114.  
  115.           If  the receiving computer is running WinPopup the user
  116.           will receive the message and probably a beep.  If  they
  117.           are  not running WinPopup the message will be lost, and
  118.           no error message will occur.
  119.  
  120.           The message is also automatically truncated if the mes-
  121.           sage  is  over  1600 bytes, as this is the limit of the
  122.           protocol.
  123.  
  124.           One useful trick is to cat  the  message  through  smb-
  125.           client. For example:
  126.  
  127.  
  128.  
  129.  
  130. smbclient                   17/1/1995                           2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. SMBCLIENT(1)                smbclient                SMBCLIENT(1)
  137.  
  138.  
  139.           cat mymessage.txt | smbclient -M FRED
  140.  
  141.           will  send  the  message in the file "mymessage.txt" to
  142.           the machine FRED.
  143.  
  144.           You may also find the -U and -I options useful, as they
  145.           allow  you to control the FROM and TO parts of the mes-
  146.           sage.
  147.  
  148.           Samba currently has no way of receiving  WinPopup  mes-
  149.           sages.
  150.  
  151.           Note: Copy WinPopup into the startup group on your WfWg
  152.           PCs if you want them to always be able to receive  mes-
  153.           sages.
  154.  
  155.        --EE
  156.  
  157.           This  parameter,  if  specified,  causes  the client to
  158.           write messages to the standard  error  stream  (stderr)
  159.           rather than to the standard output stream.
  160.  
  161.           By default, the client writes messages to standard out-
  162.           put - typically the user's tty.
  163.  
  164.        --II _I_P _n_u_m_b_e_r
  165.  
  166.           _I_P _n_u_m_b_e_r represents the IP number  of  the  server  to
  167.           connect   to.   It  should  be  specified  in  standard
  168.           "a.b.c.d" notation.
  169.  
  170.           Normally the client will attempt to locate  the  speci-
  171.           fied  Lan  Manager  server  by looking it up - that is,
  172.           broadcasting a request for the given server to identify
  173.           itself.  Using  this parameter will force the client to
  174.           assume that the server is on the machine with the spec-
  175.           ified IP number.
  176.  
  177.           There  is  no  default  for this parameter. If not sup-
  178.           plied, it  will  be  determined  automatically  by  the
  179.           client as described above.
  180.  
  181.        --NN
  182.  
  183.           If  specified,  this  parameter  suppresses  the normal
  184.           password prompt from the client to the  user.  This  is
  185.           useful when accessing a service that does not require a
  186.           password.
  187.  
  188.           Unless a password is specified on the command  line  or
  189.           this  parameter is specified, the client will request a
  190.           password.
  191.  
  192.        --OO _s_o_c_k_e_t _o_p_t_i_o_n_s
  193.  
  194.  
  195.  
  196. smbclient                   17/1/1995                           3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. SMBCLIENT(1)                smbclient                SMBCLIENT(1)
  203.  
  204.  
  205.           See the  socket  options  section  of  smb.conf(5)  for
  206.           details
  207.  
  208.        --PP
  209.  
  210.           If  specified,  the service requested will be connected
  211.           to as  a  printer  service  rather  than  as  a  normal
  212.           filespace  service. Operations such as put and get will
  213.           not be applicable for such a connection.
  214.  
  215.           By default, services  will  be  connected  to  as  NON-
  216.           printer services.
  217.  
  218.        --UU _u_s_e_r_n_a_m_e
  219.  
  220.           _u_s_e_r_n_a_m_e  is  the  user  name  that will be used by the
  221.           client to make a connection, assuming  your  server  is
  222.           running a protocol that allows for usernames.
  223.  
  224.           Some servers are fussy about the case of this name, and
  225.           some insist that it must be a valid netbios name.
  226.  
  227.           If no _u_s_e_r_n_a_m_e is  supplied,  it  will  default  to  an
  228.           uppercase  version  of the environment variable UUSSEERR or
  229.           LLOOGGNNAAMMEE in that order.  If no _u_s_e_r_n_a_m_e is supplied  and
  230.           neither  environment variable exists the user name will
  231.           be empty.
  232.  
  233.           If the service you are connecting to requires  a  pass-
  234.           word,  it  can  be  supplied  using  the  --UU option, by
  235.           appending a percent symbol ("%") then the  password  to
  236.           _u_s_e_r_n_a_m_e_.   For example, to attach to a service as user
  237.           "fred" with password "secret",  you  would  specify  --UU
  238.           _f_r_e_d_%_s_e_c_r_e_t on the command line. Note that there are no
  239.           spaces around the percent symbol.
  240.  
  241.           If you specify the password as part  of  _u_s_e_r_n_a_m_e  then
  242.           the --NN option (suppress password prompt) is assumed.
  243.  
  244.           If  you specify the password as a parameter AND as part
  245.           of _u_s_e_r_n_a_m_e then the password as part of _u_s_e_r_n_a_m_e  will
  246.           take  precedence.  Putting  nothing  before  or nothing
  247.           after the percent symbol will cause an  empty  username
  248.           or an empty password to be used, respectively.
  249.  
  250.           Note:  Some  servers  (including  OS/2  and Windows for
  251.           Workgroups) insist on an uppercase password.  Lowercase
  252.           or  mixed  case  passwords  may  be  rejected  by these
  253.           servers.
  254.  
  255.           Be cautious about including passwords in scripts.
  256.  
  257.        --dd _d_e_b_u_g_l_e_v_e_l
  258.  
  259.  
  260.  
  261.  
  262. smbclient                   17/1/1995                           4
  263.  
  264.  
  265.  
  266.  
  267.  
  268. SMBCLIENT(1)                smbclient                SMBCLIENT(1)
  269.  
  270.  
  271.           debuglevel is an integer from 0 to 5.
  272.  
  273.           The default value if this parameter is not specified is
  274.           zero.
  275.  
  276.           The  higher  this value, the more detail will be logged
  277.           to the log files about the activities of the client. At
  278.           level 0, only critical errors and serious warnings will
  279.           be logged. Level 1 is a reasonable level for day to day
  280.           running  -  it  generates a small amount of information
  281.           about operations carried out.
  282.  
  283.           Levels above 1 will generate  considerable  amounts  of
  284.           log  data, and should only be used when investigating a
  285.           problem. Levels above 3 are designed for  use  only  by
  286.           developers  and generate HUGE amounts of log data, most
  287.           of which is extremely cryptic.
  288.  
  289.        --ll _l_o_g _b_a_s_e_n_a_m_e
  290.  
  291.           If specified, _l_o_g _b_a_s_e_n_a_m_e specifies  a  base  filename
  292.           into  which  operational  data  from the running client
  293.           will be logged.
  294.  
  295.           The default base name is specified at compile time.
  296.  
  297.           The base name is  used  to  generate  actual  log  file
  298.           names.  For  example,  if the name specified was "log",
  299.           the following files would be used for log data:
  300.  
  301.              log.client.debug (containing debugging information)
  302.  
  303.              log.client.in (containing inbound transaction data)
  304.  
  305.              log.client.out  (containing   outbound   transaction
  306.              data)
  307.  
  308.           The  log  files  generated  are  never  removed  by the
  309.           client.
  310.  
  311.        --nn _n_e_t_b_i_o_s _n_a_m_e
  312.  
  313.           By default, the client will  use  the  local  machine's
  314.           hostname  (in  uppercase)  as  its  netbios  name. This
  315.           parameter allows you to override the host name and  use
  316.           whatever netbios name you wish.
  317.  
  318.        --pp _p_o_r_t _n_u_m_b_e_r
  319.  
  320.           port number is a positive integer value.
  321.  
  322.           The default value if this parameter is not specified is
  323.           139.
  324.  
  325.  
  326.  
  327.  
  328. smbclient                   17/1/1995                           5
  329.  
  330.  
  331.  
  332.  
  333.  
  334. SMBCLIENT(1)                smbclient                SMBCLIENT(1)
  335.  
  336.  
  337.           This number is the port number that will be  used  when
  338.           making  connections  to the server. The standard (well-
  339.           known) port number for the server  is  139,  hence  the
  340.           default.
  341.  
  342.           This parameter is not normally specified.
  343.  
  344.  
  345. OOPPEERRAATTIIOONNSS
  346.        Once  the  client is running, the user is presented with a
  347.        prompt, "smb: \>".  The backslash ("\") indicates the cur-
  348.        rent  working  directory on the server, and will change if
  349.        the current working directory is changed.
  350.  
  351.        The prompt indicates that the client is ready and  waiting
  352.        to  carry  out  a  user  command. Each command is a single
  353.        word, optionally followed by parameters specific  to  that
  354.        command. Command and parameters are space-delimited unless
  355.        these notes specifically state otherwise. All commands are
  356.        case-insensitive.   Parameters  to commands may or may not
  357.        be case sensitive, depending on the command.
  358.  
  359.        You can specify file names which have spaces  in  them  by
  360.        quoting  the  name with double quotes, for example "a long
  361.        file name".
  362.  
  363.        Parameters shown in square brackets  (eg.,  "[parameter]")
  364.        are  optional. If not given, the command will use suitable
  365.        defaults.  Parameters  shown  in  angle   brackets   (eg.,
  366.        "<parameter>") are required.
  367.  
  368.        Note  that  all commands operating on the server are actu-
  369.        ally performed by issuing a request to  the  server.  Thus
  370.        the behaviour may vary from server to server, depending on
  371.        how the server was implemented.
  372.  
  373.        The commands available  are  given  here  in  alphabetical
  374.        order.
  375.  
  376.        ??
  377.           PPaarraammeetteerrss::
  378.              _[_c_o_m_m_a_n_d_]
  379.  
  380.           DDeessccrriippttiioonn::
  381.              If _c_o_m_m_a_n_d is specified, the ??  command will display
  382.              a brief informative message about the specified com-
  383.              mand.
  384.  
  385.              If no command is specified, a list of available com-
  386.              mands will be displayed.
  387.  
  388.        !!
  389.           PPaarraammeetteerrss::
  390.              _[_s_h_e_l_l _c_o_m_m_a_n_d_]
  391.  
  392.  
  393.  
  394. smbclient                   17/1/1995                           6
  395.  
  396.  
  397.  
  398.  
  399.  
  400. SMBCLIENT(1)                smbclient                SMBCLIENT(1)
  401.  
  402.  
  403.           DDeessccrriippttiioonn::
  404.              If _s_h_e_l_l _c_o_m_m_a_n_d is specified, the !!   command  will
  405.              execute  a shell locally and run the specified shell
  406.              command. If no command is specified, a shell will be
  407.              run.
  408.  
  409.        ccdd
  410.           PPaarraammeetteerrss::
  411.              _[_d_i_r_e_c_t_o_r_y _n_a_m_e_]
  412.  
  413.           DDeessccrriippttiioonn::
  414.              If  _d_i_r_e_c_t_o_r_y _n_a_m_e is specified, the current working
  415.              directory oonn tthhee  sseerrvveerr  will  be  changed  to  the
  416.              directory specified. This operation will fail if for
  417.              any reason the specified directory is  inaccessible.
  418.  
  419.              If no directory name is specified, the current work-
  420.              ing directory oonn tthhee sseerrvveerr will be reported.
  421.  
  422.        ddeell
  423.           PPaarraammeetteerrss::
  424.              _<_m_a_s_k_>
  425.  
  426.           DDeessccrriippttiioonn::
  427.              The client will request that the server  attempt  to
  428.              delete  all  files  matching  _m_a_s_k  from the current
  429.              working directory oonn tthhee sseerrvveerr..
  430.  
  431.        ddiirr
  432.           PPaarraammeetteerrss::
  433.              _<_m_a_s_k_>
  434.  
  435.           DDeessccrriippttiioonn::
  436.              A list of the files matching  _m_a_s_k  in  the  current
  437.              working  directory  oonn  tthhee sseerrvveerr will be retrieved
  438.              from the server and displayed.
  439.  
  440.        eexxiitt
  441.           PPaarraammeetteerrss::
  442.              None.
  443.  
  444.           DDeessccrriippttiioonn::
  445.              Terminate the connection with the  server  and  exit
  446.              from the program.
  447.  
  448.        ggeett
  449.           PPaarraammeetteerrss::
  450.              _<_r_e_m_o_t_e _f_i_l_e _n_a_m_e_> _[_l_o_c_a_l _f_i_l_e _n_a_m_e_]
  451.  
  452.           DDeessccrriippttiioonn::
  453.              Copy  the  file  called  _r_e_m_o_t_e  _f_i_l_e  _n_a_m_e from the
  454.              server to the machine running the client. If  speci-
  455.              fied,  name  the  local  copy _l_o_c_a_l _f_i_l_e _n_a_m_e_.  Note
  456.              that all transfers in smbclient are binary. See also
  457.  
  458.  
  459.  
  460. smbclient                   17/1/1995                           7
  461.  
  462.  
  463.  
  464.  
  465.  
  466. SMBCLIENT(1)                smbclient                SMBCLIENT(1)
  467.  
  468.  
  469.              the lloowweerrccaassee command.
  470.  
  471.        hheellpp
  472.           PPaarraammeetteerrss::
  473.              _[_c_o_m_m_a_n_d_]
  474.  
  475.           DDeessccrriippttiioonn::
  476.              See the ??  command above.
  477.  
  478.        llccdd
  479.           PPaarraammeetteerrss::
  480.              _[_d_i_r_e_c_t_o_r_y _n_a_m_e_]
  481.  
  482.           DDeessccrriippttiioonn::
  483.              If  _d_i_r_e_c_t_o_r_y _n_a_m_e is specified, the current working
  484.              directory oonn tthhee llooccaall mmaacchhiinnee will  be  changed  to
  485.              the directory specified. This operation will fail if
  486.              for any reason the specified directory is inaccessi-
  487.              ble.
  488.  
  489.              If  no  directory name is specified, the name of the
  490.              current working directory oonn tthhee llooccaall mmaacchhiinnee  will
  491.              be reported.
  492.  
  493.        lloowweerrccaassee
  494.           PPaarraammeetteerrss::
  495.              None.
  496.  
  497.           DDeessccrriippttiioonn::
  498.              Toggle lowercasing of filenames for the ggeett and mmggeett
  499.              commands.
  500.  
  501.              When lowercasing is toggled ON, local filenames  are
  502.              converted  to  lowercase when using the ggeett and mmggeett
  503.              commands. This is often useful  when  copying  (say)
  504.              MSDOS  files  from a server, because lowercase file-
  505.              names are the norm on Unix systems.
  506.  
  507.        llss
  508.           PPaarraammeetteerrss::
  509.              _<_m_a_s_k_>
  510.  
  511.           DDeessccrriippttiioonn::
  512.              See the ddiirr command above.
  513.  
  514.        mmaasskk
  515.           PPaarraammeetteerrss::
  516.              _<_m_a_s_k_>
  517.  
  518.           DDeessccrriippttiioonn::
  519.              This command allows the user to set up a mask  which
  520.              will  be used during recursive operation of the mmggeett
  521.              and mmppuutt commands.
  522.  
  523.  
  524.  
  525.  
  526. smbclient                   17/1/1995                           8
  527.  
  528.  
  529.  
  530.  
  531.  
  532. SMBCLIENT(1)                smbclient                SMBCLIENT(1)
  533.  
  534.  
  535.              The masks specified to the mmggeett  and  mmppuutt  commands
  536.              act  as  filters  for  directories rather than files
  537.              when recursion is toggled ON.
  538.  
  539.              The mask specified with the mmaasskk command  is  neces-
  540.              sary  to  filter files within those directories. For
  541.              example, if the mask specified in an mmggeett command is
  542.              "source*"  _a_n_d the mask specified with the mmaasskk com-
  543.              mand is "*.c" _a_n_d recursion is toggled ON, the  mmggeett
  544.              command  will  retrieve  all files matching "*.c" in
  545.              all directories below and including all  directories
  546.              matching "source*" in the current working directory.
  547.  
  548.              Note that the  value  for  _m_a_s_k  defaults  to  blank
  549.              (equivalent  to  "*")  and remains so until the mmaasskk
  550.              command is used to change it. It  retains  the  most
  551.              recently  specified  value  indefinitely.  To  avoid
  552.              unexpected results it would be wise  to  change  the
  553.              value  of  _m_a_s_k  back to "*" after using the mmggeett or
  554.              mmppuutt commands.
  555.  
  556.        mmdd
  557.           PPaarraammeetteerrss::
  558.              _<_d_i_r_e_c_t_o_r_y _n_a_m_e_>
  559.  
  560.           DDeessccrriippttiioonn::
  561.              See the mmkkddiirr command.
  562.  
  563.        mmggeett
  564.           PPaarraammeetteerrss::
  565.              _<_m_a_s_k_>
  566.  
  567.           DDeessccrriippttiioonn::
  568.              Copy all files matching _m_a_s_k from the server to  the
  569.              machine running the client.
  570.  
  571.              Note  that  _m_a_s_k  is  interpreted differently during
  572.              recursive operation and  non-recursive  operation  -
  573.              refer  to  the  rreeccuurrssee  and  mmaasskk commands for more
  574.              information. Note that all  transfers  in  smbclient
  575.              are binary. See also the lloowweerrccaassee command.
  576.  
  577.        mmkkddiirr
  578.           PPaarraammeetteerrss::
  579.              _<_d_i_r_e_c_t_o_r_y _n_a_m_e_>
  580.  
  581.           DDeessccrriippttiioonn::
  582.              Create  a  new  directory oonn tthhee sseerrvveerr (user access
  583.              privileges permitting) with the specified name.
  584.  
  585.        mmppuutt
  586.           PPaarraammeetteerrss::
  587.              _<_m_a_s_k_>
  588.  
  589.  
  590.  
  591.  
  592. smbclient                   17/1/1995                           9
  593.  
  594.  
  595.  
  596.  
  597.  
  598. SMBCLIENT(1)                smbclient                SMBCLIENT(1)
  599.  
  600.  
  601.           DDeessccrriippttiioonn::
  602.              Copy all files matching _m_a_s_k in the current  working
  603.              directory  oonn tthhee llooccaall mmaacchhiinnee to the current work-
  604.              ing directory on the server.
  605.  
  606.              Note that _m_a_s_k  is  interpreted  differently  during
  607.              recursive  operation  and  non-recursive operation -
  608.              refer to the rreeccuurrssee  and  mmaasskk  commands  for  more
  609.              information.  Note  that  all transfers in smbclient
  610.              are binary.
  611.  
  612.        pprriinntt
  613.           PPaarraammeetteerrss::
  614.              _<_f_i_l_e _n_a_m_e_>
  615.  
  616.           DDeessccrriippttiioonn::
  617.              Print the specified  file  ffrroomm  tthhee  llooccaall  mmaacchhiinnee
  618.              through a printable service on the server.
  619.  
  620.              See also the pprriinnttmmooddee command.
  621.  
  622.        pprriinnttmmooddee
  623.           PPaarraammeetteerrss::
  624.              _<_g_r_a_p_h_i_c_s _o_r _t_e_x_t_>
  625.  
  626.           DDeessccrriippttiioonn::
  627.              Set  the print mode to suit either binary data (such
  628.              as graphical information) or text. Subsequent  pprriinntt
  629.              commands will use the currently set print mode.
  630.  
  631.        pprroommpptt
  632.           PPaarraammeetteerrss::
  633.              None.
  634.  
  635.           DDeessccrriippttiioonn::
  636.              Toggle  prompting  for filenames during operation of
  637.              the mmggeett and mmppuutt commands.
  638.  
  639.              When toggled ON, the user will be prompted  to  con-
  640.              firm  the  transfer  of  each file during these com-
  641.              mands. When toggled OFF, all specified files will be
  642.              transferred without prompting.
  643.  
  644.        ppuutt
  645.           PPaarraammeetteerrss::
  646.              _<_l_o_c_a_l _f_i_l_e _n_a_m_e_> _[_r_e_m_o_t_e _f_i_l_e _n_a_m_e_]
  647.  
  648.           DDeessccrriippttiioonn::
  649.              Copy  the  file  called  _l_o_c_a_l  _f_i_l_e  _n_a_m_e  from the
  650.              machine running the client to the server. If  speci-
  651.              fied,  name  the remote copy _r_e_m_o_t_e _f_i_l_e _n_a_m_e_.  Note
  652.              that all transfers in smbclient are binary. See also
  653.              the lloowweerrccaassee command.
  654.  
  655.  
  656.  
  657.  
  658. smbclient                   17/1/1995                          10
  659.  
  660.  
  661.  
  662.  
  663.  
  664. SMBCLIENT(1)                smbclient                SMBCLIENT(1)
  665.  
  666.  
  667.        qquueeuuee
  668.           PPaarraammeetteerrss::
  669.              None.
  670.  
  671.           DDeessccrriippttiioonn::
  672.              Displays  the print queue, showing the job id, name,
  673.              size and current status.
  674.  
  675.        qquuiitt
  676.           PPaarraammeetteerrss::
  677.              None.
  678.  
  679.           DDeessccrriippttiioonn::
  680.              See the eexxiitt command.
  681.  
  682.        rrdd
  683.           PPaarraammeetteerrss::
  684.              _<_d_i_r_e_c_t_o_r_y _n_a_m_e_>
  685.  
  686.           DDeessccrriippttiioonn::
  687.              See the rrmmddiirr command.
  688.  
  689.        rreeccuurrssee
  690.           PPaarraammeetteerrss::
  691.              None.
  692.  
  693.           DDeessccrriippttiioonn::
  694.              Toggle directory recursion for the commands mmggeett and
  695.              mmppuutt
  696.  
  697.              When  toggled  ON,  these  commands will process all
  698.              directories in the source directory (ie., the direc-
  699.              tory  they  are copying _f_r_o_m ) and will recurse into
  700.              any that match the mask specified  to  the  command.
  701.              Only  files  that match the mask specified using the
  702.              mmaasskk command will be retrieved. See  also  the  com-
  703.              mand.
  704.  
  705.              When  recursion  is toggled OFF, only files from the
  706.              current working directory on the source machine that
  707.              match  the  mask  specified to the mmggeett or mmppuutt com-
  708.              mands will be copied, and any mask  specified  using
  709.              the mmaasskk command will be ignored.
  710.  
  711.        rrmm
  712.           PPaarraammeetteerrss::
  713.              _<_m_a_s_k_>
  714.  
  715.           DDeessccrriippttiioonn::
  716.              Remove  all  files  matching  _m_a_s_k  from the current
  717.              working directory oonn tthhee sseerrvveerr..
  718.  
  719.        rrmmddiirr
  720.           PPaarraammeetteerrss::
  721.  
  722.  
  723.  
  724. smbclient                   17/1/1995                          11
  725.  
  726.  
  727.  
  728.  
  729.  
  730. SMBCLIENT(1)                smbclient                SMBCLIENT(1)
  731.  
  732.  
  733.              _<_d_i_r_e_c_t_o_r_y _n_a_m_e_>
  734.  
  735.           DDeessccrriippttiioonn::
  736.              Remove the specified directory (user  access  privi-
  737.              leges permitting) ffrroomm tthhee sseerrvveerr..
  738.  
  739.  
  740.  
  741. NNOOTTEESS
  742.        Some  servers  are  fussy about the case of supplied user-
  743.        names, passwords, share  names  (aka  service  names)  and
  744.        machine  names.  If  you  fail  to  connect try giving all
  745.        parameters in uppercase.
  746.  
  747.        It is often necessary to use the --nn option when connecting
  748.        to  some  types  of  servers.  For example OS/2 LanManager
  749.        insists on a valid netbios name being used, so you need to
  750.        supply a valid name that would be known to the server.
  751.  
  752.        ssmmbbcclliieenntt  supports  long file names where the server sup-
  753.        ports the LANMAN2 protocol.
  754.  
  755.  
  756. FFIILLEESS
  757.        Not applicable.
  758.  
  759.  
  760. EENNVVIIRROONNMMEENNTT VVAARRIIAABBLLEESS
  761.        UUSSEERR
  762.           The variable USER may contain the username of the  per-
  763.           son using the client.  This information is used only if
  764.           the protocol level is high enough to  support  session-
  765.           level passwords.
  766.  
  767.  
  768. IINNSSTTAALLLLAATTIIOONN
  769.        The  location  of the client program is a matter for indi-
  770.        vidual system administrators. The following are thus  sug-
  771.        gestions only.
  772.  
  773.        It  is  recommended  that the client software be installed
  774.        under the /usr/local hierarchy, in a directory readable by
  775.        all,  writeable  only  by  root. The client program itself
  776.        should be executable by all.  The  client  should  NOT  be
  777.        setuid or setgid!
  778.  
  779.        The client log files should be put in a directory readable
  780.        and writable only by the user.
  781.  
  782.        To test the client, you will need to know the  name  of  a
  783.        running Lan manager server. It is possible to run the smbd
  784.        (see ssmmbbdd((88)))) aass aann oorrddiinnaarryy uusseerr -- rruunnnniinngg tthhaatt sseerrvveerr aass
  785.        aa  ddaaeemmoonn  oonn  aa  user-accessible port (typically any port
  786.        number over 1024) would provide a suitable test server.
  787.  
  788.  
  789.  
  790. smbclient                   17/1/1995                          12
  791.  
  792.  
  793.  
  794.  
  795.  
  796. SMBCLIENT(1)                smbclient                SMBCLIENT(1)
  797.  
  798.  
  799. VVEERRSSIIOONN
  800.        This man page is (mostly) correct for  version  1.9.00  of
  801.        the  Samba  suite,  plus some of the recent patches to it.
  802.        These notes will necessarily lag behind development of the
  803.        client  software,  so  it is possible that your version of
  804.        the client has extensions or parameter semantics that dif-
  805.        fer  from  or  are  not  covered  by this man page. Please
  806.        notify these to the address below for rectification.
  807.  
  808. SSEEEE AALLSSOO
  809.        ssmmbbdd((88))
  810.  
  811.  
  812. DDIIAAGGNNOOSSTTIICCSS
  813.        [This section under construction]
  814.  
  815.        Most diagnostics issued by the  client  are  logged  in  a
  816.        specified log file. The log file name is specified at com-
  817.        pile time, but may be overridden on the command line.
  818.  
  819.        The number and nature of diagnostics available depends  on
  820.        the  debug level used by the client. If you have problems,
  821.        set the debug level to 3 and peruse the log files.
  822.  
  823.        Most messages are  reasonably  self-explanatory.  Unfortu-
  824.        nately,  at  time  of creation of this man page the source
  825.        code is still too fluid to  warrant  describing  each  and
  826.        every  diagnostic. At this stage your best bet is still to
  827.        grep the source code and inspect the conditions that  gave
  828.        rise to the diagnostics you are seeing.
  829.  
  830.  
  831. BBUUGGSS
  832.        None known.
  833.  
  834. CCRREEDDIITTSS
  835.        The  original  Samba  software  and related utilities were
  836.        created by Andrew Tridgell (samba-bugs@anu.edu.au). Andrew
  837.        is also the Keeper of the Source for this project.
  838.  
  839.        This man page written by Karl Auer (Karl.Auer@anu.edu.au)
  840.  
  841.        See  ssmmbb..ccoonnff((55))  ffoorr  aa  ffuullll  lliisstt  ooff  ccoonnttrriibbuuttoorrss aanndd
  842.        ddeettaaiillss oonn hhooww ttoo submit bug reports, comments etc.
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856. smbclient                   17/1/1995                          13
  857.  
  858.  
  859.